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OVERVIEH 



SCREEN MAKER is a BASIC utility program that allotN^i you to writs BASIC programs 
combining up to IS differ«flit graphics modes on your screen simultaneously* If you 

need many different mixtures of graphics modeSf SCREEN MAKER will let you make a 
package xif many different screen layouts* You decide where on each screen you are 
going to wmt large textt small textf and any of the different grephiai resolutions* 

SCREEN MAKER generates a set of BASIC subroutinest and then prints them to disk 
so that you can append them to your programt You can successfully use these 
subroutines even if you have no understanding of Atari's display list feature or 
memory requirements. SCREEN MAKER manages all of the requirements for creating 
the display l^sts needed to mix different graphics modes on one screen* You can now 
use custom itosigiied screens as easily as yiHi use the currently built-^ gri^hics 
modes* Your program simply retrieves a particular screen and lather prints or plots 
using normal BASIC statements to a particular window on that screen* 



REQUIRED ACCESSORIES OPTIONAL ACCESSORIES 



ATARI BASIC Language Cartridge One ATARI Joystick Controller 

48K RAM ATARI 825 Printer 

ATARI 810 Disk Drive 



CONTACTING THE AUTHOR 



Users wishing to contact the author about SCREEN MAKER may write to* 
Nayne Harvey 

925 Waverley St* #102 
Palo Alto, CA* 94301 
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SCREEN* This term refers to a mixture of graphics modes that you select to make up an 
entire screen display* For example, in one SCREEN you may have used Graphics 

0 in the top f|iiart«r of the TV display i Graphics 7 in the next half § and Graphics 

1 in the bottom quarter^ 



HINDOHI This term refers to any sectioh of a particular SCREEN that consists of one 

uninterrupted graphics mode* The example SCREEN above has three WINDOWS* 
the first is JQ rap hies 0# the second Js Graphics 7| and the third is Graphics 1* 
NINDOM8 can range in size from ^ small as one scan line ithe size of one 
GRAPHICS 8 line) to as large as 192 scan lines (the entire TV screen)* 



LOADING SCREEN MAKER INTO MEMORY 



1* Be sure a BASIC Language Cartridge is in the left cartridge slot of your cxsmputer 
conscde aiHt that you Mive 48K of RAM* 

2t Be sure your computer is turned off* 
3* Tum ori yeur disk t^^ 

4« When the busy light goes out^ open the disk drive door and insert the SCREEN 
MAKER 4iskett« ^rith the label in the lower right-hand corner nearest you« (Use 
disk drive miif you haw more than one dfim^ 

5* Turn on yoMr con^uter and then your TV set* The prograoi will load into computer 
iiieifiory ar^ start autofiiatically* 

6* Finally^ remove the SCREEN MAKER master diskette once it is loaded and insert into 
your disk €tfriv« a blank formatted diskette for storing files you create with this 
program* 



THE FIRST JDISPLAY SCREEN 



If you properly loaded SCREEN MAKER» you will see: 



SCREEN MAKER 



(c) 1982 



WAYNE HARVEY 



Af t#r a nunutet a selection of seven cocnau|nds will appear on a menu* 



XJSINO SCREE2M IXEAKER 



THE SCREEN MAKER MENU 



I I 

I MENU i 

I I 

I 0 Directory of disk J 

I I 

I 1 Establish a fiew screen file i 

I I 

I 2 Create a new screen I 

I I 

I 3 Load and nodif*^ or test s screen 1 

I ^ Save screen ' I 

I I 

I 5 Generate subroutine | 

■1 ^ ' -I 

I 6 End progran I 

I ! 

I I 

I Choose P - 6 ? I 

I ^ I 



0* Direetorv of disk? This command lists all of the files on the disk in the particular 
disk drive you specify« 

1* Establish ^ new scfeen fm « When you want to retrieve work from a past SCREEN 
MAKSR session or save newly areated screens* you must give SCRSEM MAKER a 

filename« This name can be up to eight letters with no extension (disk drive number 
is optional)* 

2; Create a new screen : Use this command when you wish to m<4c# it new screim 
whether it is the first screen you are creating or a new screen you are adding to an 
existing package of screens* (See "Using The SCREEN MAKER Editor"*) 

3f Load and modify or test a screen t A previously Mved screen or a screen you just 
created can be recalled by this command ♦ You may make modifications to your 
screen design and resave iti pr you may f imply see how things look using SCREEN 

4« Save screen ? Whenever you create a new screen or modify an old one^ you must save 
it by using this command* If you do not save a new screen* you will lose it; if you 
do not save a modified screent you will lose the changes and retain the old version 
before modification* Each screen is siiveil in a^ different file named "filename*#'' 



where "filename" is the current screen file (see menu item #1) and is an integer 
^ from I to 10 corresponding to the number of the screen being saved* - 

5« Generate subroutine ? Tou stMUld not usii this cammmd until yoii have created all the 
screens that you will want to incorporate into your program* You can end a session 
with SCREEN MAKER without {jenerating your subroutine and come back sometime 
l*t«r to finish designing your scr*«ts« This command allows you to include only 
those screens you want in your subroutine (usually all that you created )i numbered 
in any order you wish« Your subroutine is stored in a file named "Filename«SRC" 
where "filename" is the current screen file* 

6. End program ' Use this command to return to BASIC* 



USING THE SCREEN MAKER EDITOR 



Use the editor to tell SCREEN MAK£R the layout of the graphics modes you want on 
eat^scfMn* The folkiwing example iMWws how to define the S!0«sn layoi^^ 



I I 
I GRAPHICS 7 I 

I I 
I I 

C_ J BLANK I 

I I 

I GRAPHICS 1~ — — I 

0Si J 1 

J BLANK I 

I . I 

I GRAPHICS 7 I 

I I 

I I 

F_ J " ■ ..-.'v:, I 

1 GRAPHICS 1 J 



SCREEN MAKER will ask! 

What is the predominant mode — 

BASIC modes 0 - 8, or Blank? ? 

1* One begins with the entire screen in one mode* li^hich mode you chomw is fairly 
mrbitrary* but in this example* sir^e most of the scri^ is Graphics 7t one would 

^ type a "7"« An arrow will show up at the top of the screen (point A)« 

2* Move the arrow down to point B using the keyboard wrrovt keys and prnss "B" f«r 
Blank* Areas designated; as "Blank^ will always appe«r bladt when yOu use your 



screen* No information can be written to blank areas* 

3» Move ttie amw to poiirt C and prM# n% 

■ - '■■ ■■ « " 

• ■ 

4# Move the^row to point D and press "B"* 

5. Move the arrow to point E and Mt RFTURMt Ho need to typ© ii "T'* hpr» mir^ ••7" is 
the background mode* 

6« Mpv(t the arroim io point F and press "l"* 

7* Move the arrow to point G and press RETURN* 

8t Press ESC to exit edit^g session* 



FEATURES OF THE SCREEN MAKER EDITOR 



1* To define a window* 

- Position the arrow anywhere on the screen (including the bottom)* 

- Press a iiraiihiw mode numbe 

- Move ttle arrow anyv^here else on the screen* 

- Press RETURN or type in a new mode number to define another window* 

The area between tlie two locattons of the arrows will ry»iir be a window cif the given 

graphics mode* 

2f The arrow wraps around the screen top or bottom^ but windows are defined by the 
area between the arrow's starting point and ending pointt . Thus a window never 

wraps around the top or bottom of the screen* 

3t To redefine a window! 

^ Position ^ arrow %^thin or the edge of an already defined window* 

- Type in a new mode number* 

- Reposition the arrow where you want the edge of the newly defined window* 

4* IMPORTANT! SCREEN MAKER does not let you tle^ile iKTems that wo^^ 

impossible to construct (i*e*t that violate scan line requirements)* For example, 
when you define a window as being Graphics 2f you can only move the arrow in line 
widths that are the size of Graphics inode 2 lines« If you add a window of Graphics 
8 on top of this» SCREEN MAKlil will only let yotireplaoe multiples of a full 
Graphics mode 2 line (16 scan lines) with Graphics 8 so as not to leave a fraction of 
a mode line* 



TESTING A SCREEN 

■. ' ' . • 'i. . " ■ 

SCREEN MAKER'S test feature allows you to preview your display by typing 
characters into your text windows on your custom screen and drawing in your graphics 
i^dows using a joystick* SCREEN MAKiJi allows you to do this by setting Up your 
custom display list and handling the trans^r cif datm to KrMi^RAM# Although SCHEEN 
MAKER will not allow you to manipulate colors at this timet you can get a sense of the 
relative positioning and sizes of information displayed on your screent , 

When typing information into your text windowst you may use the four keyboard arr6M 
keys and the return key to move your cursor* You also may use the delete-backsp key 
for editing your text and the dear key to entirely clear any window on your screent Use 
the ESC key to exit the testing modet 

Warning: When you finish testing a screent you will be unable to save any pictures you 
dr»«# or text you t^ied« 



HOW TO US£ YOUR SUBROUTIIilEs 



After SCREEN MAKER generates the subroutines needed to use your custom screens, it 
is a simple matt«r to integrate them into yiiyr o^n program* You communicate with the 
SCREEN MAKER subroutiries ttHNXfgh fb^ vaHdltesf SCREEN 1 1>01ilXlf9» CLEAR» 

and MYSCREEN^ Your BASIC program should assign values to SCREEN, WINDOW, and 
CLEARt and follow this with th% statement "GOSUB MYSCREEN"* Exilinples and 
explanations of how to do tMs are shown in the following demonstration program* 

The value in variable SCREEN tells one subroutine which of your screens you want 
displayed* HIIIDOH teUs the subroutine wliich windoiitf yiH^ will be printing on* If 
CLEAR has a value of imro when you call the subroutine! any text or graphics previously 

written to the window will remain untouched, otherwise the memory corresponding to the 
current window will ^ 

Avoid using variable names fhat begin with XX in your BASIC program, because such 
names are used by the subroutine* Also, do not use line numbers greater than 30000 or 
line number 0* Once you have entered your program (or retriaved it by using the LOAD 
command), you ffiiiHit append the SCREEN MAKER mibrautine to it* To d^^this# type tiie 
direct command (no line number) ENTER "Dtfilename.SRC- where "filename*SRC" is the 
file in which SCREEN MAKER stored your subroutine* You can now save your entire 
fir€^ram including the subroutine by typing SAVE "Dlfilenafpe"* Then later you can load 
the entire program into nrnmory with only one LOAD oomman^* 

The following is an example, with explanations, of a program that uses two custom 
jsoreens* This program is stored in a f ile caUed DEMQt To see it run» load DOS from 
another diskette, then insert the SCRESlf MAiCEB iliaspter diskette and type: RUN 
"Di:DEMO"t 



SCREEN *1 



SCREEN *2 



2 
3 



5 



7 



1 GRAPHICS 


3 1 


1 GRAPHICS 


1 1 


1 GRAPHICS 


5 1 


1 GRAPHICS 


2 1 


1 ^GRAPHICS 


5 1 


1 GRAPHICS 


1 1 


1 GRAPHICS 


3 1 



2 
3 



4 

5 



i GRAPHICS 


7 1 


1 GRAPHICS 


0 1 


1 GRAPHICS 


7 1 


1 (?RAPHSP§ 


0 1 


1 GRAPHICS 


7 1 
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110 REM SCREEN MAKER Deno pro^raM* 

112 REM By Wayne Harvey 
11-1 REM (c) 1982 
llA REM 

120 OPEN *lf^tOf "Kt»' ISETCOt-dR 2,0 , fl I E8C-27 J RTN»t55 MRAP 300 

130 REM 

132 REM To print to our custoM screens, we need 

134 REM to tell our subroutine which ttereen and which 

136 REM window we are going to use* 
138 REM 

140> REM :icxxxxxxx)K)K]iuKxxiKXXxxxxxxxxxxxxx 
112 SCREEN»i:MIND0M«lS60SUe MYSCREEN 

J £1 )IC 5IC 3iC 3(C JIC 5IC 5IC 5(C )IC 5IC 5IC )IC JIC }IC 5IC 5IC JIC 5(C 5IC 5IC JIC 5IC JIC 3IC 3(C 3IC 3IC 3K 

150 REM 

152 REM Jhm ifppmr lmt% corner of the wincton is consicterii4 

15^ REM positicm OfO* We can draw outside of %he windowr 

156 REM as is done beloWf and our lines will show up in all 

158 REM windQws of the sane Mode^ In this exanple our lines 

160 REM show up in both wHndow *1 and in window #7 at the 

162 REM bottoM of our screen^ B€ith of tties* windows are 

16^ REM graphics Mode 3* 

166 REM 

1''^^ 0 It M 3(C 3IC 3IC 3IC 3IC 3iC 3lt 3IC 3IC )iC 3IC 3iC 3K3iC3(t 3iC3IC 5IC 3IC )K Ht 3IC 3K 3IC3IC3i53i55K 

172 COLOR 1:PL0T 0,0:DRAWTO 39,23 
17^ COLOR 2:PL0T 39,0:DRAWTO 0,23 

iA [Ti \^ w 

180 REM 

182 REM We can change windows on the sane screen and draw in 

181 REM graphics node 5* Our lines are drawn below window #3^ 
186 REM and thorafora also show through ih window #5* 

188 REM 

190 REM )K!K;K)K)KXX}K;K}tC)K;K}K}K)K}K)K)K)K)KXXXXXXXXXX 

192 WINDOW=ajCOSUB MYSCREEN ' 

191 COLOR 2: PLOT 2,5: DRAMTO 78^5 

196 COLOR 1:DRAWT0 78,17 
198 COLOR 2:DRAWT0 2,17 " - 
COLOR IJDRAWTft 2,5 

202 REM XCXllt3K3ltX1KXMiinilX3K3KX 

210 REM 

212 REM We now print text to our text windows ♦ We define our 

Z14 REM window as *2 and print two lines of text* Uir«|iow #2. 

216 REM is only one line wide» so the second line Is >rin^i^^ 

218 REM to the next window of the sane node - window *6* 

220 REM 

^2 ^3 0 <^ 

232 WIND0W=2:G0SUEi MYSCREEN 

231 PRINT *6}" TO CLEAR A WINDOW" 

236 PRINT *6J" TYPE A 1 THRU 7" 

(3 r*i r** lyC %y \v \y u# 



2^0 REM 

2^2 REM Next we print to our other text window* 

24^ REM 

2150 RiEM )K )IC )IC )K )IC )K )K )K )K )IC )K )K )l( )IC )K 5iC )IC )l()lt)ICMC)IC)IC5IC5CXX3itXX 

252 WINDOW='l :GOSilB MYSCREEN 

254 PRINT *6f"»«c; for other »CP««n" 

256 REM )K)KXX)K)KXX}KXX»tXXX]KXXXXX]KX«XX]RXK 

258 TRAP 30 0 

300 GET *1,KEY 

302 IF KEY-E8C THEN 400 

310 REM 

312 REM To clear 3 window* set CLEAR=1» store the window 

314 REM nunb«r andi call tha sMlj^routine* Onl«j that one window 

316 REM gets clean«#» Hlhdowa Continue to ba eltfafad until 

318 REM CLEAR is set to 0* 
320 REM 

330 REM XXXXXXXKXXXXXXXXXXXXXXXXXXXXXX 

332 CLEAR=1 :WINDOW=VAL(CHR*<KEY) ) :G0SUB MYSCREEN 
33'^ REM )kx>k)k>k}K}K}K}K3K}K)K}K)k:k}K)k:k)K)k>k>kx;k}K}k>k}ic}K}k 

340 GOTO 300 
400 REM 

402 REM Next we call op our second screen* When we do this» 

404 REM all of our first screen MeMory disappears* As before 

406 REM our plottinQ shows in all windows of the sane node* 
408 REM 

410 REM >K>ic)tc>t:>K)ic)rx*x)K>K>ic>K)ft«x5«*>tt)K>tc)K)ic;(()KX)K)r)t( 

412 clear=i:screen=2:window=i:gosub myscreen 

414 COLOR 2:PL0T 0,0$DRAMTO 159,95 

416 COLOR 1:PL0T 159,0:DRAWTO 0,95 

^ ^ Q E ^ ^ ^ ^ JIC 5IC }IC JIC JIC 5IC 5IC 5IC JIC 5IC )K X )K JIC )K JIC )K JIC 5(C 5IC }iC 5IC 5IC 

420 REM. 

422 REM And wa Can write to oor text windows individual !«:)* 
424 REM 

432 WIND0W-2IC0SUB MYSCREEN 

434 PRINT " Press ESC for other screen*" 

436 window=4:gosub myscreen :first=i 

438 PRINT " Prass RETURN to switch text*" 

440 REM xxxxxxxxxxiixxxxxxxxxxxxxxxxixxx 

450 GET *1,KEY 
452 IF KEY=ESC THEN 140 
454 IF KEYORTN THEN 450 
456 IF NOT FIRST THEN 436 
460 REM 

462 REM We can reuse a selected screen very sinply* 

464 REM I ; 

470 REM XXXXXXXXXXXXXXXk}KXXXiK)KXXX}KXXXX 

472 WIND0W=4JG0SUB MYSCREEN :FIRST«0 

474 PRINT " Replacing text is easy. Press RETURN*" 

REM )(C )(C )K )K )K )IC^,,^ 5(K JIC^IC )K JjK )ICi^ 

480 GOTO 450 " f 




Cannot save Sfreen or Qannot open "filenafne" for printing on this distU Your diskette 
or file im probably write protected or tliere ^e no free ttec±orSf You may have sectors 

with bad data. The best cure is to change diskettes and try again* Be sure the diskette 
you use is formatted* 

Illegal name ? File names must have no extension and be 8 letters or fewer* 

You have no screens * You tried to save, modifyi or test a screen, but none have been 
created yet* 

No screen to save * You tried to save a screen# but you have not created one or recalled 
and modified one« 

Screen »n is not retrievable* A previously created screen contains bad data or cannot be 
found on the disk* You probably will have to recreate the screen 

Illegal screen num* The screen number you specified does not exist* 

Reached maximum number of screens * You tried to create another screen» but there are 
already lOf the maximum number* 

You must first save vour screen * You tried to generate the subroutine before you saved 
any screens* To correct thist save your screen by choosing menu item #4* 

Cannot open directory on drive n * The directory cannot be found on the disk drive you 
spcKdfied* Tour drive may be turned off or it may have a different drive number than the 

one you provided* 

Cannot write to printer! You asked for a paper copy of your display, but an I/O error 
occurred* You probably forgot to turn on the printer or the interface* 

Insufficient memorv to test display without overwriting program space ? WARNING! Do 
not test display after receiving this message unless you have saved your last screen* If 
you proceed t you will be able to test your displayt but you will not be able to return to 
the menu and therefore you will not be able to save any of the work you did after your 
last save* You will have to reload SCREEN MAKER to do anything more* 
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OVERVIEW 



SCREEN^MAKER is a^BASIC wtility program wMch enables you to combine up to 15 
different graphics mo^^^^^^ on the screen simultaneously. Additionally, SCREEN MAKER 
allows you to define up to ten different screen mutures in whichyoL dedde^here on 
each^creen you wish to place different size text ahd/or different graphics windl^s. 

SCREEN MAKERgenerates a BASIC subroutine which you enter into your own program. 
You do not need any knowledge of the workings of Atari's display list featTe^; 
meniory requirements to successfully utilize the power of this pfog^ T^di^^ 
and. implementation of the custom display lists needed to Savi^ss^SS 
graphics modes^on the Atari, and th^ necessary %6ks for your pro^-^^^tolS^^ 
arMotally handled by SCREEN MAKER and made invisible to you. tTe user. Thus; 
using your custom designed screens is as easy fusing the Oirr^t Luilt^g;anhS 
nar^A UA^V"?:"^ ^"T^^. ""^^ ^ P^^icular screened either prints or Xts^slZ 

Soi fn^ f f ^^"'^^^ on that screen. Windows^ b« 

Cleared and reused, as can screens* » uu#w5» 



REQUIRED ACCESSORIES 



ATARI BASIC tangyage Cartridge 
48KRAM 

ATARI 810 Disk Drive 



OPTIONAL ACCESSORIES 



One ATARI Joystick Controller 
AT4RI S25 Printer 



COHTACTING THE AUTHOR 



Usefs vrfshing to contact the author about SQREEli MAKER fnay writ^ toi 
Af ARI Special Projects 

1196 Borregas Ave* ^^^^^^^ 

PO Box 427 ■ ■ ; ' 

or call him at? '^'--.^ -.' ^I.-p^^^- " ^ /'"^'-C"--. " 

(408) 745-4991 



SCREENI This term refers to a mixture of graphics modes that you select tp make up an 
enlire screen display* For ^xarnplei in one SCHEEN yoi^nay h^e us^ Graphics 

0 in the top quarter of the TV display, Graphics 7 in the next half, and Graphics 

1 in the bottom quarter* 

WINDOWl This term refers to any section of a particular SCREEN that consists of one 
uninterriipted graphics modet The example SCREEN above has three l4IliDOWS« 
the first is Graphics 0, the second is Graphics 7, and the third is Graphics !♦ 
WINDOWS can range in size from as small as one scan line (the size of qnp 
GRAPHICS 8 line) to as large its IS^ scan lines (the ent 
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LOADING SCREEN MAKER INTO MEMORY 



1. Be sore a BASIC Language Cartridge is in the left cartridge slot of your computer 

console and that you have 48K of RAM. 7 «. vu MHwitsr 

2. Haye yipur computer turned off, 

-Turn on -your di$H driven,/ : . . ' '"''^^ 

^' ^r^/™^! ^'3^^ °Pen the disk drive door and insert the SCREEN 

MAKER diskette with the laberift the lower right-hand corner nearest you. (Use 
cnsk c»iy||0ne if you have more than one drive.) 

5. Turn on your^computer #nd y«jr 5etr^^^# wilf load into computer memory 

and start automaticaUy. ; 

6, It is advisable to. remqye the SCREEN MAKER master diskette once it is loaded and 

insert into your disk drive a blank formatted diskette for storing files you create 
with this program. , ., 



THE FIRST OjaPLAY SCREEN 



you will seeJ 



I 



SCREEN MAKER 



r 



WAYNE HARVEY 



i 



I PLEASE WAIT A MOMENT | 



After a minute, a selec|ion of eight commands will appear on a mehU« 
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THE SCREEN MAKER MENU 



I MENU I 



I 



I 1' £»t«blish/Switch scrjeen file | 



I 



I 



I 2 Create new screen | 



I 



I 



I 3 Modify/Test a screen | 



I 



I ^ Save screen i 

I ' I 

15 Generate ^mUtou tine | 

I 6 Instructions* creating screen I 

I '^^"^ ■ ' r,.: - ,'' ,1 

17 Xnml^ructionsJ ;test^ screwn | 

I ^' - . I 

I 8 End prografi | 

I . 1 

I Choose 1 - 8 ? 1 



Establish/Switch screen file! Always begin your SCREEN MAKER session with this 
Item, You must provide a filename with no extension (disk drive number is^ 
optional). SCREEH M4KER creates three files? "fiiename.CtL% "filename.DAT", 
and "filenaTOe.8RC". tJte first two files are used to store information about your 
custom-designed screens for later retrieval and modification by SCREEN MAKER, 
"file name. SRC" is used to store #*B subroutines generated by SCREEN MAKER for 
later imxirpofat^ into your progriims. 

2« Create fle w screen! Use this command when you wish to make a new screen — 
whether it is the first screen you are creating or a new screen you are adding to an 
existing series. (See "Using The SCREEN MAKER Editor".) 

3» Modify/Test a screen: A previously saved screen can be recalled by this command. 
You may make modifications to your screen design and resave it, or you may simply 
see how things look ijsing SCI?£E1^ jy^E^^^ 

4f Save scre^f^ "i^fmnm^ you create a new screen or modify an old one, you must save 
it using this command* If you do not save a new screen, you will lose itj if ,yau ckl 
not save, a modified sfreenf ypu will retain the did versicMi before itfiCK^ 



5« Generate subroutine ? This c^manil sHd^ld not be used until you ha^ve ireited all the 
screens that you will want to incorporate into your program* You can end a session 
with SCREEN MAKER without generfting your subrQutii^i^ and^ to back at a later 
date to finish designing your screehsv The command allows you to include only 
I those screens you want in your subroutine (usually all that you created^ numbered 

6# Instructions for creating screen ? This command provides helpful reminders for 
first-time users^ ;": - _ -/ :-vi..;- ''^ 

?• Instructions for testing screen ? SCREEN MAKER'S test feature allows you to type 
characters into your text windows on your custom screen and to draw in your 
graphics windows usii^ a ysj^tidc to preview ycHir disp^^ SCREEN MAKER alloi^i 
you to do this by setting up your custom display list and handling the transfer of 
data to screen RAMit Although SCREEN MAKER will not allow you tq manipulate 
colors at this timet you can get a ^mm^mm^ th« 1rf^lative positiwing and sizes of 
information displayed on your screen. 

8« End prog rami Always exit the prm^sm m%kh this^oinifiandi Failure tcj inay 
result in loss of sofi^ CMT IAI of 



USING THE SCREEN MAKER EDITOR 



Use the editor to tell SCREEN MAKER the layout of the griipihics modes you wai^t on orie 
scre^nr The following example shoiwrs ti^w td de^^ 



I GRAPHICS 7 I 

\ -I ^ 

I BLANK L 

I — ^-.~r-GRAPHICS 

E~ I BLANK ^ I 

^ I I • 

I GRAPHICS 7 I 

J ■ ■ --^'^ L 

G_ JL GRAPHICS 1 L 

*' " ■ . 



SCREEN MAKEE wiU aslU 



What is the p^racLomifiant mocie 
BASIC modes 0 - 8, oir Blartk? 



One begins with the ei^tire screeitjn Qn€ moila»^d.^I^ is fairly 

arbitrary^ but in this #*amplei since most of the screen is Graphics 7, one would 
C type a "7". An arrow will show. up at the top of the screen (point A)f > 

2# Move the arrow down to point B using the keyboard arrow keys and press "B" for 
, Blank* - -'^-'r- " ^ ; 

,.4* Move the arrow to p{?irit D^^a^^ 

5# Move the arrow to point E and hit RETURN* No need to type a "7" here since "7" is 
V . the background mode* ^ ^ , 

Move the arrow to point F and press 

7* Move the Wi^ow to point G and hit 

8# Hit ESC to exit editing session* 



FEATURES OF THE SCI^gH IIJ^R ^ * 

1* ^©u can il^ placing the arrow anywhere on the screen (including the 

bottom)f pressing a graphics mode number# and moving the arrow anywhere else on 
the screen* When you hit RETUBNi the space betisiefen tht two locations of tt»t^ 

S 

2t The arrpw wraps around the screen top or bottom* but windows are defined by tt» 
area between the arrow's itaf ting point and ending point* Thus a window never 
^ w^^s around the top or bottom of the screen* ^ v 

;.3t...To recie^e-^A:' window! ^ ^^^^^^^^^ 

- position the arrow within or at the edge of an already defined window* 

- type in a new mode number* > ? 

- reposition the arrow where yiou want the edge of th^li^ly defined window* 

4* IMPORTANT! SCREEN MAKER does not let you try to define screens that are 
impossible to construct (i*e*f that violate scan line requirements)* For examplet 
^r^-:f - when you define a window as being Graphics 2, you can only move the arrow in line 
widths that are the size of Graphics mode 2 lines* If you add a window of Graphics 
, 8 on top of this, SCREEN MAKER will only let you rf place multiples of a Jul! 
Grap hies mQd« 2 linii lines) with Graphics 8 so lot ^ leavtn J^raction of 

a mode line* "'-^i':- ' - ' 




, HOW TO USE YOWR SUBROXTTIINEI 



Af ter SCREEN MAKER fleiierates the s«ibroytin&^ your custom screens, it is 

a simple matter to integrate it into your own program. You communicate with the 
SCREEN MAKER subroutine through four special variable^l SCREEN, WINDQW, CLEAR, 
and MySCREENf Your BASIC prog rim should assign valyesMo BGIIEEN, WINDOW, and 
CLEAR, and follow this with the statement "GOSUB MYSCREEN"* Examples and 
explanations of hpw to do this are shovyn in the fo^o^vyinp demonstration jprogramt i 

The value in variable SCREEM tells the subroutine which of your screens you want 
displayed* WINDOW tells the subroutine which window you will be printing on* If 
CLEAR has a v^ue of Jtero when you qill ti>e swbroutioer arty text previously 
written to the window mir^ i^tiruchedj otherwise memory corresponding to the 

current window will be cleared. 

Avoid using variable hames which begin with XX in your BASIC program since such 
names are used by the subroutine* Alsoi do npt use line numbers above 30000 or line 
number 0* Once you hf ye typed in your firogr am (or retrieved it using the LOAD 
corrmtand), you must merge the SCREEN MAKER subroutine to it* To do this, type the 
direct command (no line number) ENTER "Dtfilename" where "filename" is the file in 
which SCREEN MAKER stored your subroutinet Ymi caii how resave ycHir entire program 
including the subroutine by typing SAVE "DJfilename"* Then at a later date you can load 
the entire program into memory with only one LOAD command* 

The following is an eiamplet with explanationSf o# a program which uses two custom 
screens* This program, along with the subroutines generated by SCREEN MAKERi is 
stored in a file called DEMO* To see it run, type; RUN "DllDEMO'U 



SCREEN *1 



SCREEN *2 
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GRAPHICS 3 
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I 



:2 
3 



1 



1 



1 
I 

f 



GRAPHICS 7 



GRAPHICS 7 
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110 REM SCREEN MAKER Deno prp9ran# 
IIZ REM By Wayne Hsrv#y 
11-^ REM (c) 1982 

116 REM 

120 OPEN *1 ,^ rO , "K : SETCOLOR 2 , 0 ^ 0 : ESC==27 ;RTN=^1551 TRAP 30 Q 
130 REM 

132 REM To print to our custon screens^ we need 
13^ RE|1^^ -^^^^ ser##l^ and 

136 45tEM window i*© 3r« going to use# 
138 REM 

1-10 REM x)*:xxx3ic^x>i^)i:x)i:xxxxxxxx)i:xxx^ 

1^2 SCREEN=lJWIND0i4«ilG0SUB MYSCREEN 
1^^ REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

••ISO. .-REM -V-^^^^^^^ ^ ' '"^ 

152 REM TN# upper left corner of the window is considered 
15-1 REM position 0^0* We can draw outside of the windoWf 
156 REM as is done belpWf and our line^ will show up^^^ i all 
158 REM windows of the S3n# node « Iri thi^^ #Kafiple our lines 
160 REM show up in both window *1 and in window *7 at the 
162 REM botton of our screen* Both of these windows are 
164 REM graphics mode 3# ^ 
166 REM 

170 REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
172 COLOR irPl^OT ^f^lDRAWTO 39,23 . 
17^ COLOR 2: PLOT 39,0tDRAWTO 0,23 
176 REM xxxxxxxxxxxxxxxxxxxx^5>:xxxxxxxx 
_ 180 REM 

182 REM We can change windows on the sane screen and draw_i-n 
■ 18-9 REM graphics Mode 5» Our lines are dr^^wn below window #3 
186 REM and thej^ef or# almo show through irr window *5* 
188 REM 

190 REM xxxx)i(xx)*:xxxxxxxxxxxxxxxxxxxxxx 

192 window=3:gosub mysgreen 

19^ COLOR 2:PL0T 2,5:DRAWT0 78,5 

196 COLOR 1 :DRAWT0 78,17 

198 COLOR 2:DRAWT0 2,17 

mo COLOR ItDRAMtO 2,5 - 

|\ f ''i w^M ^fr^ ^fr^ ^fr' ^fr^ ^fr' 

U / , | \ I 1 , % 

^,zip._REM /:■■._.-•/■:"" ... ■ 

^ 212 R^ now print text oui^ ttfKt windows* We define our 

21^ REM window as *2 and print two lines of te^t* Hindow *2 

V 214 REM is onlji one line wide, sQ th« second lin^ is pr ifii^^ 
218 REM IItjO the neK^ window of the saH^M^ode -^ window *6* 

.22 0 REM 

230 REM xxxx}*c}*(X}*:xxxxxxxxxxxxxxxxxxxxxx 

232 window=2:gosub myscreen ^^^^^^' 5 

23^ PRINT *6;" TO CLEAR A WINDOW" 
236 PRINT t6r' TYPE A 1 THRU 7»» 

238 REM xxxxxxxxxxxxxxxxxx^^^**'^*^^^*^*^^^ 
2^0 -REM ■ ' 

2^2 REM Next we print to our other text window* 
2^^. REM - • ■ '-B--'k:L 
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250 REM xjrxxxjKx^ixxxxxxxxxxxxxxxjicjicxjitxJiCK 

252 WINDOW-'^iGOSyB HYSEREEN 

25'^ PRINT *6;"esc for other screen"**^^^^^^ ^ 

256 REM '^^^^^^'Kxxx.xxxxxxxxxxxxxxxKxxxxxx 

300 GET *1,KEY - , ■■ --v-^ • 

302 IF KEY=ESC THEN -100 

310 REM ' : . , \' ' ; ; / .. ' 

» wi'^dowr set CLEAR=1, store the window - 

oIm ^^11 the subroutine. Only that one window 

?}fl PPM rfiL^^^''^i\ Windows conttmie to be cleared until 
J18 Ktn CLEAR IS set to * 

320 REM ■ ' ^ 

330 REM Jtcxxxxxxxxxxxxxxxxxxxxxxxxxxxxx * V? ' 

332 CLEAR=i:wiNDQW=VALtCHR*<KEY>) JCOSyB MYSCREEN J 
33'<» REM JK5KX3KX«>icji3|txxxx3rKxx»:«xxxxxxxxxxx 

3-10 GOTO 300 

•^QO REM \ :r : . . „.;x. 

iJS^ DrS r ''^^i.'-'P second screen. When we.,do this, 

^0^ REM all of our first screen MeMory disappearsv before 
lit PlottirtQ show* inv all windows of the sane mode. 

■110 REM ^xxxxxxxxxxxxxxxxxxxxxxxxxxxxx ^ ^ " 

^12 SCREEN=2:WIND0W=1JG0SUB ^YSCREEN 
VI 1-* COLOR 2:PL0T 0,OJDRAWTO 159,95 
^16 COLOR 1:PL0T 159,0:DRAWTQ 0,95 
■^18 REM xxxxxxxxxxxx 
^20 REM 

111 ^"""^ 'fe pan write to our text jrfindoyws in^vAdualla^ 

-130 REM ««JKXXXXXXXXXXXXXXXXXXXXXX)KXXXX 

^32 WIND0W=2:G0SUB MYSCREEN V' ■ ■m-^'-ii' ■ ■ :.y 

^3^ PRINT " Hit ESC for other screen .'-^^^^^^^^^ ^ ^^^^^^ -^^ 

-134- WIND0W='1 J GOSUB MYSCREEN :FIRST=1 
-138 PRINT " Hit RETURN to switch text." - 

^^0 REM )i<xxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
-150 GET *1,KEY 
^52 IF KEY=ESC THEN 1-90 
-15^ IF KEYORTN THEN ^50^^^^^^' " 

-^56 IF NOT FIRST THEN 436 ^^^^^^ ^^^^^v* 

460 REM 

^62 REM We can reuse a selected screen very si«Ply. 

^6^ REM ■ 

^70 REM 5KXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

-172 window=^:gosub myscreen;first=o 

^7^ PRINT " Replacing text is easy. Hit RETURN*" 

176 REM *«5K**3KXXXXX*XXXXXXXXXXXXXXXXXX 
48»";(»OT0 -150 -.v;; 




SCREEN MAKER always checks any conditions necessary to carry opt a command before 
it|pDceed|s« Ttiie faUc^win§ 4rf^e^^ the error siti^atixma i^^ 

1 ♦ You must establish>^ screen file ? You tried to u#e ^REEK M^KEibj^^re giving it a 
working file name 

2# lUeoal name ? File names must have np extention and be 41pttert^0r less# 

3# You have no screens ? You tried to save, modifyi or test a screen, but none have been 

preated yet#.#' - ■ ■ - ; ' 

4» No screen to save t You tried to save a screen, but you have not created one or 
orecalled aynd mod 

5* Screen #n is not retrievable ? A previously created screen contains bad data or 
cannQJt..ht found on the^diskt It could result from having copied a file frompnedisk 
to another liecatos©^ SCREEN MAKER keeps pointers to sectors Wi^ t 
to locate data* In any case, you probably will have to recreate the screen* 

6» Illegal screen num t The streen number you speci^ed doesfiot ea;istf 

7# Reached maximum number of screens ; You tried to create another screenf but there 
are already 1 Or ttm maximum number* 

8* Cannot write to printer ? You asked for a paper copy of your display, but an I/O error 
occurred* You groba^ly forgot to turn on the printer or the interfaoe« 

9* Insufficient memory to test display without overwriting program^nace t WARNING! 
Do not te&t display after receiving this^iDi^&sageiinless you have saved everything* 
If you proceed, you will be able to test your display, but you will not be able to 
return to the menu and therefore you will not be able to save any of the work you 
did. after yoyr las| save* You will have, to reload SCREEN IsykKER to do anything 





SCREEK MAKER handles all of the i#efnory boundary conditions necessary for making 
custom display lists and user-defined screen RAM. The display list for each screen is ~ 
copied by an assembly routine from a string array (XXDJ**) to page 159 in memoty$ 
Screen RAM is placed below thiSf and RAMTOP is reassigned so that uses of other 
graphics modes do not interfere with your custom display list or associated screen RAM* 
The display list handles places w^re scsrepp BA^^^^ RAM is also 

allocated so that BASIC'S graphics ^tatemenls can be used as if the entire screen were 
in one mode while the user only sees what shows through the windows defined in that 
mode (see prqflram in "Sample Applicat . 

Memory is not organized by the order of the windows# The low end of screen RAM is 
used for Graphics mode 0 lines with Graphics 1 next, then Graphics 2, on up to the high 
end of screen RAM for Graphics 8 memory. Display list instructions tten point to th# 
appropriate places in screen RAM* Of course, if no window were defined for a particular 
gjraphics model then np memory is allocated f 



